home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _utilities / utilities / 003 / _termhost / !TermHost / !Help next >
Text File  |  1994-04-24  |  6KB  |  169 lines
  1. Term Host ⌐ David Brain 1993
  2. ****************************
  3.  
  4. Legal Bit:
  5. This program is freeware, and as such may be distributed freely so long 
  6. as no profit is made, the programs remain unaltered, and this file is 
  7. included in all copies.
  8.  
  9. The copyright remains mine (⌐David Brain 1993) and I accept no 
  10. liability for any damage, loss of profits etc. that may arise from use of 
  11. this software.
  12.  
  13. Instructions
  14. ************
  15.  
  16. This program allows a terminal to run a command line via the serial 
  17. port.  I have found this to be of particular use for debugging programs, 
  18. viewing text files, etc all of which can be done from the desktop but 
  19. take up valuable screen space (even in mode 31).
  20.  
  21. This program only supports 3 wire Xon/Xoff communication at speeds 
  22. between 300 and 19200 baud.  I have only tested this program on my 
  23. A5000/CIT-101 Newbury termial and so I have no idea whether this 
  24. program will work on any other platforms (not many people have the 
  25. hardware - any feedback would be appreciated!).  I have particular 
  26. doubts as to whether it will work on machines with the old serial 
  27. controller chips.
  28.  
  29. In this file I will assume that you already know how to set up the 
  30. terminal, serial cable etc - if you really get stuck contact me at the 
  31. address below and I'll try to help (if I can!).
  32.  
  33. When the program loads it will place an icon on the icon bar (with a 
  34. flashing green light - cute eh?).
  35.  
  36. The menu items are as follows:-
  37.  
  38. Info:
  39. *****
  40. Gives info about program.
  41.  
  42. Set Up...
  43. *********
  44. Selecting this menu item opens the settings window.  This should be 
  45. fairly self explanatory.  It allows you to set the baud rate, parity and bits 
  46. to be the same as those of the terminal.  It is also possible to set what 
  47. type of terminal you are using, the wimp slot the terminal task will run 
  48. in, and whether control characters are to be allowed by the terminal 
  49. task.  Clicking on OK will set these options.  Some will only take effect 
  50. after the terminal task has been re-started (you will be warned of this).
  51.  
  52.  
  53. Commands..
  54. **********
  55.  
  56. Selecting this menu item open the command window.  This has two 
  57. icons:-
  58.  
  59. Start up Command :- this is the command that is issued every time the 
  60. terminal task is started.
  61.  
  62. Drag Command :- this is the command that is executed every time a file 
  63. is dragged to the iconbar icon, sensible settings for would be 'type' (the 
  64. default) or 'cat'.  When a file is dragged to the icon <Command> 
  65. <Dragged file name> is executed.
  66. Again Clicking on OK sets these options.
  67. Clicking menu over the command window gives you the option to open the
  68. set up window (see above) or save the settings.
  69.  
  70. Save
  71. ****
  72.  
  73. This saves the current settings (set from the two above menu items) to a 
  74. file that is loaded automatically when the program is loaded.
  75.  
  76. Pause
  77. *****
  78.  
  79. This temporarily stops the terminal task - useful if you need the 
  80. processing time.
  81.  
  82. Re-Start
  83. ********
  84.  
  85. Re-Start quits the current terminal task (and hence stops whatever it is 
  86. doing), and starts a new one.  This is of use if the current task becomes 
  87. stuck , or to change some settings (see above).
  88.  
  89. Quit
  90. ****
  91.  
  92. Quits the application.
  93.  
  94.  
  95. The Icon
  96. ********
  97.  
  98. The iconbar icon changes depending on the terminal state. A green 
  99. 'light' flashing ~1Hz indicates normal operation. If the flashing 
  100. becomes eratic it indicates that the applications output buffer is full - 
  101. the terminal task will be suspended until the buffer becomes empty 
  102. (this is of no real concern to the user - but it's nice to know).  When the 
  103. pause is selected from the menu the icon's 'screen' will go dark, and a 
  104. yellow 'light' will flash at ~1Hz, until pause is de-selected.  If the 
  105. terminal task fails - ie you quit it from the task manager etc, the Icon 
  106. will go completely mad with little red 'lights' and a flashing '!' (oh what 
  107. a trivially silly bit of coding).  With luck 'Re-Start' from the menu will 
  108. get things going again.
  109.  
  110. As mentioned above dragging a file/directory to the icon can be made 
  111. to execute a command on that file/directory.
  112.  
  113. 'Undocumented features'
  114. **********************
  115. 1.
  116. Setting the system variable Terminal$Task will replace the command 
  117. that is used to start the terminal task, this is primarily intended for use 
  118. with Brian Brunswick's !Virtual. ie having
  119. 'set Terminal$Task virtual' in !Run will use virtual instead of the 
  120. taskwindow module.
  121.  
  122. 2.
  123. NB. this one can cause 'strange' effects.
  124. The program can take two (must be two) command line parameters the 
  125. first is the size of the applications internal buffer - this is the buffer 
  126. where the output from the task window is placed before it is output to 
  127. the serial port  (to compensate for the fact that the taskwindow module 
  128. may stuff data out faster than the serial port can output it).  When this 
  129. buffer is full the task is halted until it has been emptied.  Hence a large 
  130. buffer would mean that the task had to be halted less often.
  131. The second parameter is the maximum number of characters that are 
  132. written from the above buffer between polls - the lower this figure the 
  133. more "multi-tasking friendly" displaying large pieces of text become.
  134.  
  135. eg.  having  :-
  136.  
  137.      Run <TermHost$Dir>.!RunImage 1280 10
  138.  
  139. gives a 1280 byte buffer with 10 characters per poll (this is the default 
  140. if no parameters are given).
  141. It won't accept (most) silly values as parameters.
  142.  
  143.  
  144. Where I am
  145. **********
  146.  
  147. If for any reason you wish to get in touch with me I should be at the 
  148. email address below for the next couple of years:-
  149.  
  150.         braindl@sun.aston.ac.uk
  151.  
  152.  
  153. History
  154. *******
  155.  
  156. 1.00 5/12/93 - First truly working version.
  157. 1.01 6/12/93 - Bug fix on 'first truly working version' + nicer menu: 
  158.                Test release version.
  159. 1.02 5/02/94 - Fixed 'flashing light' bug + minor code improvements.
  160. 1.10 21/03/94 - Changed windows to be more Style Guide ish.
  161.                 Menus altered, and more code improvements.
  162.  
  163.  
  164. Things To Do
  165. ************
  166.  
  167. Add support for serial block drivers by Hugo Fiennes.
  168. Perhaps (as it would mean a fairly major re-code) add multiple terminal/
  169. session support.